home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / DESKTOP / SAVEDESK.SPK / !SaveDesk / !Help next >
Text File  |  1994-09-13  |  7KB  |  169 lines
  1.                                 Forward>>Motion
  2.                                    SaveDesk
  3.                                  For Risc OS 3
  4.  
  5.                                  Version 1.00
  6.                         © Nick Jarman Tue,23 Aug 1994
  7.  
  8.  
  9. *****************************************************************************
  10. ****   SaveDesk needs to be set up manually before it will do anything   ****
  11. ****                    this doesn't take very long!                     ****
  12. *****************************************************************************
  13.  
  14.  
  15. About the program
  16. -----------------
  17.  
  18. A quick implementation of an idea I had this afternoon: The Pinboard
  19. application is always running on my computer to display a marble effect
  20. backdrop. This is rather a waste of 64K of memory if that's the only thing
  21. I'm using it for.
  22.  
  23. The ability to drag files and directories onto the desktop is useful, but I
  24. usually want them to stay there after the computer has been turned off or
  25. reset. It's a drag to have to save the pinboard manually, and I can guarantee
  26. I'll forget to do it before hitting Ctrl-Shift-F12! Anyway, I'd like it to
  27. save the directory viewers I have open as well. Pinboard can't do this.
  28.  
  29. What I'm describing is similar to the behaviour of the Apple Macintosh
  30. desktop. It will start up in much the same state as it was in when it was
  31. last shut down. This is very useful if you've plastered your desktop with
  32. useful directories and applictions.
  33.  
  34. SaveDesk pulls together Pinboard and your boot sequence to provide this
  35. functionality. It takes a bit of care to set up, but once it's working it
  36. should integrate seemlessly with your desktop environment!
  37.  
  38.  
  39. How to use it
  40. -------------
  41.  
  42. If you have a Risc PC, or Risc OS 3.50 on any other computer (?!?) read on.
  43. If you don't, read the 'Pre-Risc OS 3.50 users' section.
  44.  
  45. Risc OS 3.50 comes with a standard !Boot application which is easy to
  46. customise without changing it out of all recognition. This makes it a lot
  47. easier to describe how to set up SaveDesk...
  48.  
  49. - Copy the SaveDesk module into !Boot.Resources
  50. - Use Edit (or your preferred text editor) to create an Obey file containing
  51.   the following:
  52.          Set SaveDesk$Name <Choices$Write>.Boot.Tasks.SaveDesk
  53.          Run Boot:Resources.SaveDesk
  54. - Call this file SaveDesk, and save it in the !Boot.Choices.Boot.PreDesk
  55.   directory
  56. - Set the type of SaveDesk to Obey
  57.  
  58. Now shut your computer down and restart it. SaveDesk will appear on the Task
  59. display in the Module tasks section. To test it, open a few directories and
  60. drag some icons onto the desktop. Shut the computer down and restart it.
  61. When the boot sequence has finished, the icons and filer windows will be on
  62. your desktop in the same position as they were when you shut it down.
  63.  
  64.  
  65. Pre-Risc OS 3.50 users
  66. ----------------------
  67.  
  68. This is slightly more difficult to explain than for Risc OS 3.50 since there
  69. is no standard !Boot directory structure. You are left to define your own, so
  70. it can be as complex or as simple as you like. This section is therefore
  71. based on the structure explained in section 7 of the Risc OS 3 User Guide -
  72. 'Desktop boot files'. If you are not familiar with desktop boot files, read
  73. section 7 of the User Guide now.
  74.  
  75. - Copy the SaveDesk module into whichever directory you like on your hard
  76.   disc. Maybe a utilities directory, but definitly somewhere out of the way
  77.   which will not be accidentally renamed or deleted. This may also be the
  78.   directory where you want SaveDesk to put its configuration file (see
  79.   below)
  80. - Identify your desktop boot file and load it into Edit (or your preferred
  81.   text editor).
  82. - Add the following three lines at the end of the file:
  83.          Set SaveDesk$Name <Your_Choice>
  84.          Run <Full_pathname_of_SaveDesk>
  85.          Run <Your_Choice>
  86.   Replace <Your_Choice> with the full pathname of SaveDesk's configuration
  87.   file. This is the file to which it saves information about your desktop
  88.   when you shut it down.
  89.   Replace <Full_pathname_of_SaveDesk> with the full pathname of SaveDesk!
  90.   To clarify this, here's an example. Assume your hard disc is called
  91.   HardDisc4, and you put SaveDesk in a directory called Utils.Startup. You
  92.   would add these lines to your desktop boot file:
  93.          Set SaveDesk$Name adfs::HardDisc4.$.Utils.Startup.DeskState
  94.          Run adfs::HardDisc4.$.Utils.Startup.SaveDesk
  95.          Run adfs::HardDisc4.$.Utils.Startup.DeskState
  96.  
  97. Now shut your computer down and restart it. Don't use the Restart button
  98. which is displayed after you press Ctrl-Shift-F12, because it doesn't work
  99. properly on some machines. Press Ctrl-Reset instead. When your computer
  100. restarts an error message will be displayed. For the example above it would
  101. be:
  102.           File 'adfs::HardDisc4.$.Utils.Startup.DeskState' not found
  103. don't worry about this; it will not occur again. Just click on Cancel, and
  104. the desktop will be displayed. SaveDesk will appear on the Task display in
  105. the Module tasks section. To test it, open a few directories and drag some
  106. icons onto the desktop. Shut the computer down and restart it. When the boot
  107. sequence has finished, the icons and filer windows will be on your desktop
  108. in the same position as they were when you shut it down.
  109.  
  110.  
  111. History
  112. -------
  113.  
  114. V0.01 (Tue,23 Aug 1994)
  115.      Prototype - written in Basic to see if the idea would work. It did.
  116. V1.00 (Tue,23 Aug 1994)
  117.      It may as well be done properly... this calls for a relocatable module
  118.      written in assmebly language. It takes a lot less memory: The smallest
  119.      Wimpslot a Basic program can have ranges from 8K-32K. The module takes
  120.      just less than 2K, including workspace.
  121.  
  122.  
  123. Testing
  124. -------
  125.  
  126. SaveDesk has been tested with the following machine/operating system
  127. combinations:
  128.  
  129.      Machine     OS
  130.      A400/1      Risc Os 3.10
  131.      Risc PC     Risc OS 3.50
  132.  
  133.  
  134. Further development
  135. -------------------
  136.  
  137. It's so simple, what is there to add?
  138.  
  139.  
  140. SaveDesk is distributed under the Acorn User PD Scheme
  141. ------------------------------------------------------
  142.  
  143. The application may not be copied or distributed to any third party until
  144. three months after publication of this issue of Acorn User, i.e. until
  145. 6th January 1995. After that rights to the program revert to the author,
  146. and the program may be distributed subject to the following conditions:
  147.  
  148. This application may be feely distributed as long as it is not altered in any
  149. way, and no profit is made doing so. If you use SaveDesk, you do so entirely
  150. at your own risk.
  151.  
  152. If you intend to distribute SaveDesk through a public domain software
  153. library, please obtain my permission first. This way I can ensure you have
  154. the latest version of the software, and that you are kept up to date
  155. regarding any significant changes.
  156.  
  157.  
  158. The Author
  159. ----------
  160.  
  161. Comments and suggestions are welcome. Send them to this address:
  162.  
  163.       Nick Jarman
  164.       7 Cadet Way
  165.       Church Crookham
  166.       FLEET
  167.       Hants
  168.       GU13 0UG
  169.       UK